Markdown (y Rmarkdown)

Documentos sencillos, rápidos, y versátiles

Daniel Morillo

Universidad Autónoma de Madrid

10 de junio de 2021

Bienvenidos/as

Introducción a Markdown


¿Qué es Markdown?

Introducción a Markdown


Markdown es…
un lenguaje de marcado:


Texto
+
Marcas de formato
# Introducción a Markdown

**Markdown** es...

un _lenguaje de marcado_:

Texto

\+

Marcas de formato

Tiene “trampa”:
Animaciones, columnas

Introducción a Markdown

Markdown también es…


Pandoc

Permite convertir a:

  • HTML
  • Word
  • PDF


¿Por qué usar Markdown?

Es muy legible:

# Título 1


## Título 2

**negrita** y _cursiva_

* puntos

* importantes

1. lista de

1. elementos

1. numerados

Título 1

Título 2

negrita y cursiva

  • puntos

  • importantes

  1. lista de

  2. elementos

  3. numerados

¿Por qué usar Markdown?

Es muy legible:

### Título 3

#### Título 4

[enlace](https://www.ccomsuam.org/)

![logo MD](www/assets/md_logo.png)

>Si buscas resultados distintos,
>no hagas siempre lo mismo.

--Albert Einstein

Título 3

Título 4

enlace

Si buscas resultados distintos, no hagas siempre lo mismo.

–Albert Einstein

¿Por qué usar Markdown?

Aunque permite insertar:

  • HTML/CSS:


<center style='color:darkblue'>Estoy centrado y en azul</center>


Estoy centrado y en azul

¿Por qué usar Markdown?

Aunque permite insertar:

  • \(\LaTeX\):


$Y = \beta_1 X + \epsilon$


\(Y = \beta_1 X + \epsilon\)

¿Por qué usar Markdown?

Es muy rápido:


Contenido


Formato

¿Por qué usar Markdown?

Es interoperable

MS Word:

Pero…

  • No es WYSIWYG:
(what you see is what you get)


(Aunque hay editores, e.g.: StackEdit)

Pero…

  • Requiere herramientas específicas de colaboración


Aprender Markdown

Es extremadamente sencillo:

Aprender Markdown

También conviene conocer extensiones comunes:

Rmarkdown


¿Qué es Rmarkdown?

¿Qué es Rmarkdown?

Extensión de markdown

Consiste en:


¿Qué es Rmarkdown?

Cálculos



    PERCENT <- n_control / n_total * 100

El grupo control representó el `r PERCENT`% del total.


El grupo control representó el 31.5% del total.

¿Qué es Rmarkdown?

Gráficos
ecs_bl %>% ggplot(aes(x = q1011_age)) + geom_histogram(fill = "lightblue")

¿Qué es Rmarkdown?

Tablas
ecs_bl %>% as_factor() %>% count(q0001_rc, proxy) %>% kable()
q0001_rc proxy n
Finland Yes 42
Finland No 1934
Poland Yes 131
Poland No 3940
Spain Yes 170
Spain No 4583

¿Qué es Rmarkdown?

Extensión de markdown

Consiste en:

Encabezado (YAML):

---
title: "Habits"
output:
  pdf_document:
    toc: true
    number_sections: true
---




(Ejemplo de R Markdown: The Definitive Guide)

Formatos

HTML



Formatos

HTML

leaflet() %>% addTiles() %>%
  addMarkers(lng   = -3.690926, lat   = 40.481403, popup = "CCOMS UAM")

Formatos

Otros


Formatos

Documentos




Ejemplo

  • Documento (múltiples formatos)

Ejemplo

  • Artículo

Ejemplo

  • Reenviar un artículo

¿Merece la pena aprender?


  • Markdown


  • Rstudio


  • R


  • Nociones de HTML y \(\LaTeX\)

¿Merece la pena aprender?


  1. Ahorro de esfuerzos


  2. Desarrollo profesional


  3. Ciencia abierta: Reproducibilidad + Replicabilidad

Una agradable sorpresa…


Flujo de trabajo

  • Automatización con Rmarkdown:

Conclusión

Markdown es…


  • legible

  • productivo

  • fácil de editar

  • fácil de mantener

Conclusión

Rmarkdown…


  • es versátil

  • es gratis!

  • evita trabajo repetitivo

  • facilita la reproducibilidad

Saber más


Saber (aún) más

“Retos”

Nivel 1: Tutorial markdown


“Retos”

Nivel 2: Instalar entorno Rstudio

install.packages("tinytex")
library(tinytex)
install_tinytex()

“Retos”

Nivel 3: Replicar guía de instalación de OneDrive

install.packages("revealjs")

FIN




Eso ha sido todo

¡Muchas gracias!

Atribuciones